Resource URL: /platform/<<version=3>>/fsa/results/<ID>/histogram/<STAT>/by

    Overview: Retrieve a breakout of the STAT histogram according to BREAKOUT
              parameter.

     Methods: GET

********************************************************************************

Method GET: This resource retrieves a histogram breakout for an individual FSA
            result set. ID in the resource path is the result set ID.

       URL: GET /platform/<<version=3>>/fsa/results/<ID>/histogram/<STAT>/by

There are no query arguments for this method.

GET response body schema:
{
  "type": [
    {
      "additionalProperties": false, 
      "type": "object", 
      "description": "A list of errors that may be returned.", 
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false, 
            "type": "object", 
            "description": "An object describing a single error.", 
            "properties": {
              "field": {
                "type": "string", 
                "description": "The field with the error if applicable."
              }, 
              "message": {
                "type": "string", 
                "description": "The error message."
              }, 
              "code": {
                "type": "string", 
                "description": "The error code."
              }
            }
          }, 
          "type": "array"
        }
      }
    }, 
    {
      "type": "object", 
      "properties": {
        "result_length": {
          "required": true, 
          "type": "integer", 
          "description": "Total length of the result list."
        }, 
        "breakouts": {
          "items": {
            "type": "object", 
            "properties": {
              "data": {
                "required": true, 
                "type": "array", 
                "description": "List of bucket, file count pairs.", 
                "properties": {
                  "bucket": {
                    "required": true, 
                    "type": "integer", 
                    "description": "Stat histogram bucket."
                  }, 
                  "value": {
                    "required": true, 
                    "type": "integer", 
                    "description": "Number of files in bucket."
                  }
                }
              }, 
              "key": {
                "required": true, 
                "type": "string", 
                "description": "Breakout key by which results are filtered."
              }
            }
          }, 
          "required": true, 
          "type": "array", 
          "description": "Histogram breakout data according to breakout parameter."
        }, 
        "begin_time": {
          "required": true, 
          "type": "integer", 
          "description": "Unix Epoch time of start of results collection job."
        }
      }
    }
  ]
}
